home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 4 / United Public Domain Gold 4.iso / fredfish / ff.0536.dms / ff.0536.adf / Chemesthetics / Source / SrcReadMe! < prev    next >
Text File  |  1991-09-03  |  4KB  |  99 lines
  1. Hints for programmers: (updated 18-Jun-91)
  2. ---------------------
  3.  
  4. First, all source files have been compressed into an archive (Source.LZH)
  5. using Lharc V1.30 (AmigaLibDisk 404). I have included Lharc V1.30 on my
  6. distribution disk. However I don't know if all PD-distributors leave it
  7. there, so you may be have to get elsewhere. All other (older) versions of
  8. Lharc should also work, though I have not tested them.
  9.  
  10. All source files have been compiled with the SAS/Lattice C 5.10a Compiler.
  11. All files use 32-bit-integer variables so I hope there is no problem in
  12. this aspect.
  13.  
  14. Besides source-file-specific headerfiles (*.h) which are located in the
  15. source root directory (on the same level as the *.c files they belong to),
  16. I provide all the needed header files for the req.library, the arp.library
  17. and the iff-reader (ilbmw.c). Because I don't want to bother you with my
  18. filesystem-structure, I compressed them into the source archive
  19. (Source.LZH) *WITHOUT* pathnames. After extracting them, they are all
  20. located in the source root directory. This causes problems when you compile
  21. certain files (for example ilbmw.c), because the include files are supposed
  22. to be located in a subdirectory (in this case iff/). You may either change
  23. the #include lines in the problem files or you may create a subdirectory
  24. INCLUDE below the source root directory and include the -i option in the
  25. lmkfile at the CFLAGS. If you do so I recommend to organize the include
  26. files as follows:
  27.  
  28. source/
  29.   *.c        source-files
  30.   *.h        other header files
  31.   include/
  32.     clib/
  33.       req_protos.h
  34.     libraries/
  35.       reqbase.h
  36.       arpbase.h
  37.     iff/
  38.       compiler.h
  39.       gio.h
  40.       iff.h
  41.       ilbm.h
  42.       packer.h
  43.     req.h
  44.  
  45.  
  46. A lmkfile is provided, so Lattice users could simply type LMK and the
  47. compile process will run automatically.
  48.  
  49. Be careful in changing rev.c, as it has a special format that is needed by
  50. other files.
  51.  
  52. All source files come with German comments and (partly) German names for
  53. routines and variables. If you would like to know what they mean, well, try
  54. learning German, it's a fascinating language.
  55.  
  56. The newer files are ANSI-C compatible and they are compiled with the -ca
  57. option of the compiler. The current version is a mixture of ANSI and
  58. non-ANSI files, I intend to make ALL files ANSI compatible in the future.
  59.  
  60. After purchasing the SAS/Lattice compiler I read something called #pragmas.
  61. It is said that it reduces the code and time for calling Amiga library
  62. routines. I built in these pragmas in the newer files using the proto/
  63. includes. I didn't have time to do this everywhere, so may be later
  64. versions will be smaller and faster. Let's see...
  65.  
  66. I have some problems in writing a convenient message-receiving routine.
  67. Sometimes the GURU will visit you if you select a menu or close a window. I
  68. reduced the frequency of the Guru's appearance by using ARP's
  69. CloseWindowSafely() instead of Intuition's CloseWindow(), but it still
  70. happens sometimes. PLEASE: If anyone has a solution for this please let me
  71. know. I looked thru lots of computer magazines but I didn't find anything
  72. else than my Nachricht() (-> Message) routine.
  73.  
  74. I use my own (well actually it comes from QuickReq.c from AmigaLibDisk457)
  75. _main() routine to get rid of that f***ing console window that is opened by
  76. all files compiled with the Lattice compiler (take that away Lattice, it
  77. must be up to the programmer to include this!). The console window that is
  78. now opened is my own (see OpenRevWin in extra.c) and I need it to display
  79. certain messages.
  80.  
  81. I intended to provide a makefile for Aztec C users and to embedd Lattice
  82. specific things in #ifdefs but I didn't have the time yet. If somebody does
  83. this, I would like to get a copy of this. If nobody does I may do it on my
  84. own somewhere in time... Let's wait'n'see!
  85.  
  86.  
  87. Have fun!
  88.  
  89. Joerg
  90.  
  91.  
  92. P.S. None of the files may be touched, changed, deleted or distributed on
  93.      own series of Stefan Ossowski PD-Versand, Rainer Wolf PD-Versand
  94.      (OASE), Markt & Technik Verlag AG and Karstadt AG!
  95.  
  96.      Greetinx to Bernstein Softworks (Risk, Dragon Cave) for their RIGHT
  97.      attitude concerning some kind of PD distributors.
  98.  
  99.